home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2001 May / SGI Freeware 2001 May - Disc 2.iso / dist / fw_netpbm.idb / usr / freeware / catman / u_man / cat1 / ppmcie.Z / ppmcie
Text File  |  2001-01-10  |  9KB  |  199 lines
  1.  
  2.  
  3.  
  4.      PPPPPPPPMMMMCCCCIIIIEEEE((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm    VVVV ((((22226666tttthhhh    SSSSeeeepppptttteeeemmmmbbbbeeeerrrr 1111999999994444))))         PPPPPPPPMMMMCCCCIIIIEEEE((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       ppmcie - draw    a CIE colour chart in a    portable pixmap
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       ppppppppmmmmcccciiiieeee [----nnnnoooobbbbllllaaaacccckkkk] [----nnnnoooowwwwppppooooiiiinnnntttt]    [----iiiinnnntttteeeerrrrppppwwwwpppp] [----ffffuuuullllllll]
  13.            [----cccciiiieeee|----eeeebbbbuuuu|----hhhhddddttttvvvv |----nnnnttttsssscccc|----ssssmmmmpppptttteeee] [----rrrreeeedddd _r_x _r_y]
  14.            [----ggggrrrreeeeeeeennnn _g_x _g_y] [----bbbblllluuuueeee _b_x _b_y]    [----wwwwhhhhiiiitttteeee    _w_x _w_y] [----ssssiiiizzzzeeee
  15.            _e_d_g_e] [----xxxxssssiiiizzzzeeee|----wwwwiiiiddddtttthhhh    _w_i_d_t_h] [----yyyyssssiiiizzzzeeee|----hhhheeeeiiiigggghhhhtttt _h_e_i_g_h_t]
  16.  
  17.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.       ppppppppmmmmcccciiiieeee creates a portable pixmap containing a     plot  of  the
  19.       CIE ``tongue'' colour    chart, showing the colour gamut    of ei-
  20.       ther a standard or user-specified colour  system,  annotated
  21.       with    axes,  a mark indicating the white point of the    colour
  22.       system, and the black    body chromaticity curve    for  Planckian
  23.       radiators  from 1000 to 30000    kelvins.  The axes are labeled
  24.       with the CIE X and  Y     coordinates,  the  periphery  of  the
  25.       tongue is annotated with the wavelength of light, in nanome-
  26.       tres,    of the pure hues which appear  there,  and  the     black
  27.       body    chromaticity  curve  is    marked with the    temperature in
  28.       kelvins.
  29.  
  30.       CIE charts, by their    very  nature,  contain    a  very     large
  31.       number  of  colours.     If  you're  encoding  the chart for a
  32.       colour mapped    device or file    format,     you'll     need  to  use
  33.       ppppppppmmmmqqqquuuuaaaannnntttt or ppppppppmmmmddddiiiitttthhhheeeerrrr    to reduce the number of    colours    in the
  34.       image.
  35.  
  36.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  37.       ----cccciiiieeee||||----eeeebbbbuuuu||||----hhhhddddttttvvvv||||----nnnnttttsssscccc||||----ssssmmmmpppptttteeee
  38.             Select a standard colour system whose  gamut  (the
  39.             area  inside the triangle formed by    the three pri-
  40.             mary colours) and white point are  plotted    within
  41.             the     CIE  tongue  chart.  The default is ----eeeebbbbuuuu, the
  42.             primaries used in the PAL and  SECAM  broadcasting
  43.             standards.     ----nnnnttttsssscccc chooses the primaries specified
  44.             by the NTSC    broadcasting system (few modern     moni-
  45.             tors  actually  cover this range).    ----ssssmmmmpppptttteeee selects
  46.             the    primaries recommended by the Society of    Motion
  47.             Picture  and Television Engineers (SMPTE) in stan-
  48.             dards RP-37    and RP-145, and    ----hhhhddddttttvvvv  uses  the  much
  49.             broader  _H_D_T_V  _i_d_e_a_l primaries.  ----cccciiiieeee uses the CIE
  50.             RGB    primaries with wavelengths of  700  nm,     546.1
  51.             nm,    and 438.8 nm respectively; the CIE white point
  52.             is defined by equal    R, G, and B intensities.
  53.  
  54.       ----rrrreeeedddd _r_x _r_y
  55.             specifies the CIE _x    and _y co-ordinates of the  red
  56.             illuminant    of  a custom colour system and selects
  57.             the    custom system.
  58.  
  59.       ----ggggrrrreeeeeeeennnn _g_x _g_y
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 12/12/00)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      PPPPPPPPMMMMCCCCIIIIEEEE((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm    VVVV ((((22226666tttthhhh    SSSSeeeepppptttteeeemmmmbbbbeeeerrrr 1111999999994444))))         PPPPPPPPMMMMCCCCIIIIEEEE((((1111))))
  71.  
  72.  
  73.  
  74.             specifies the CIE _x     and  _y     co-ordinates  of  the
  75.             green  illuminant of the colour system and selects
  76.             the    custom system.
  77.  
  78.       ----bbbblllluuuueeee    _b_x _b_y
  79.             specifies the CIE _x    and _y co-ordinates of the blue
  80.             illuminant    of  the     colour    system and selects the
  81.             custom system.
  82.  
  83.       ----wwwwhhhhiiiitttteeee _w_x _w_y
  84.             specifies the CIE _x     and  _y     co-ordinates  of  the
  85.             white  point  of the colour    system and selects the
  86.             custom system.
  87.  
  88.       ----ssssiiiizzzzeeee    _e_d_g_e
  89.             Create a pixmap of _e_d_g_e by _e_d_g_e pixels.   The  de-
  90.             fault is 512x512.
  91.  
  92.       ----xxxxssssiiiizzzzeeee||||----wwwwiiiiddddtttthhhh    _w_i_d_t_h
  93.             Sets the width of the  generated  image  to     _w_i_d_t_h
  94.             pixels.   The default width    is 512 pixels.    If the
  95.             height and width of    the image are  not  the     same,
  96.             the     CIE  diagram  will be stretched in the    longer
  97.             dimension.
  98.  
  99.       ----yyyyssssiiiizzzzeeee||||----hhhheeeeiiiigggghhhhtttt _h_e_i_g_h_t
  100.             Sets the height of the generated image  to    _h_e_i_g_h_t
  101.             pixels.  The default height    is 512 pixels.    If the
  102.             height and width of    the image are  not  the     same,
  103.             the     CIE  diagram  will be stretched in the    longer
  104.             dimension.
  105.  
  106.       ----nnnnoooobbbbllllaaaacccckkkk  Don't plot the black body chromaticity curve.
  107.  
  108.       ----nnnnoooowwwwhhhhiiiitttteeee  Don't plot the colour system's white point.
  109.  
  110.       ----ffffuuuullllllll        Plot the entire  CIE  tongue  in  full  intensity;
  111.             don't  enhance  the     gamut of the specified    colour
  112.             system.
  113.  
  114.       ----iiiinnnntttteeeerrrrppppwwwwpppp Interpolate    out-of-gamut colours using the    colour
  115.             system's white point as the    origin of the interpo-
  116.             lation line.  By default, the white    defined    by  an
  117.             equal mix of the three primaries is    used.
  118.  
  119.       All flags can    be abbreviated to their    shortest  unique  pre-
  120.       fix.
  121.  
  122.      BBBBUUUUGGGGSSSS
  123.       Obviously, colours outside the gamut of the device  used  to
  124.       view    or  print the CIE chart    cannot be rendered accurately.
  125.       Colours outside the Maxwell's    triangle formed    by  the     three
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 12/12/00)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      PPPPPPPPMMMMCCCCIIIIEEEE((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm    VVVV ((((22226666tttthhhh    SSSSeeeepppptttteeeemmmmbbbbeeeerrrr 1111999999994444))))         PPPPPPPPMMMMCCCCIIIIEEEE((((1111))))
  137.  
  138.  
  139.  
  140.       illuminants  are desaturated and rendered as the shade where
  141.       the edge of the gamut    triangle intersects a line drawn  from
  142.       the  requested  shade    to the white point defined by an equal
  143.       mixture of the illuminants (or  the  colour  system's     white
  144.       point,  if  ----iiiinnnntttteeeerrrrppppwwwwpppp     is  specified).   These  out of gamut
  145.       colours are drawn ``subdued''    at 3/4 the  intensity  of  the
  146.       shades  within  the  gamut unless the    ----ffffuuuullllllll switch is    speci-
  147.       fied,    in which case in-gamut and out of  gamut  colours  are
  148.       not distinguished.
  149.  
  150.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  151.       ppppppppmmmmddddiiiitttthhhheeeerrrr(1),    ppppppppmmmmqqqquuuuaaaannnntttt(1), ppppppppmmmm(5)
  152.  
  153.      AAAAUUUUTTTTHHHHOOOORRRR
  154.         Copyright (C) 1995 by John Walker (kelvin@fourmilab.ch)
  155.             WWW    home page: http://www.fourmilab.ch/
  156.  
  157.       Permission  to  use,    copy,  modify,    and  distribute      this
  158.       software  and     its documentation for any purpose and without
  159.       fee is hereby    granted, without any  conditions  or  restric-
  160.       tions.   This    software is provided ``as is'' without express
  161.       or implied warranty.
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                        (printed 12/12/00)
  196.  
  197.  
  198.  
  199.